home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / bbs_util / ex130.zip / EX.DOC < prev    next >
Text File  |  1994-07-15  |  5KB  |  118 lines
  1.  
  2. Ex -- the External transfer protocol CD-ROM download driver.
  3.   Program and documentation (C) Copyright 1994 Strange Systems.
  4.  
  5. *******************************************************************************
  6. Ex is released as shareware.  User is granted a 14 day evaluation period.
  7. Usage after 14 days requires registration.  Registration for Ex and all future
  8. updates to Ex is (in US funds) $10 for non-commercial users up to 5 lines, $20
  9. for non-commercial users over 5 lines, and $25 for commercial users, unlimited
  10. lines.  For this document, commercial users are defined as any system
  11. requiring pay-for-access of any kind.
  12.  
  13. The standard registered version of Ex supports up to 25 Volumes and copies up
  14. to 25 files per run; custom versions are available on request for additional
  15. cost.  Send registrations to:
  16.  
  17.                  Roger Morris
  18.                  PO Box 52183
  19.                  Shreveport, LA 71135-2183
  20.  
  21. (We are working towards credit card and online registrations)
  22. *******************************************************************************
  23.  
  24. Purpose
  25.   Ex was designed to copy files off of CD-ROM drives before downloading them.
  26.   Works with all external transfer protocols that use a redirection file for
  27.   the download list, via the @ character and is host (BBS) software independant.
  28.   Ex needs a config file to determine your system setup; default is Ex.Cfg but
  29.   can be overridden by the -c command line option.
  30.  
  31. Operation
  32.   Ex tracks and sorts by drive up to 50 files per session, and copies up to 5
  33.   files as needed, loads the transfer driver, and deletes the copied files
  34.   before returning to the host program.  Registered versions copy up to 25
  35.   files per session.  The errorlevel returned from Ex is whatever the transfer
  36.   program exited with.  If the file transfer module didn't load, then 255 is
  37.   returned.  Running Ex with no parameters brings up a blurb screen and exits
  38.   with errorlevel 0.
  39.  
  40. OS/2 or DOS
  41.   Ex comes in both native OS/2 32-bit and DOS 16-bit versions.  Both versions
  42.   use the same config file and utilize a temporary file named Ex.Tmp that is
  43.   created in the same directory as the redirection file.
  44.  
  45. Command line
  46.   Ex reads the command line for an alternate config file and the redirection
  47.   file.  Everything after the config file entry is expected to be a transfer
  48.   driver filename and it's associated parameters.  Ex reads and, if needed,
  49.   rewrites the redirection file.  A typical command line is:
  50.  
  51.   Ex [-cConfig.Fil] FZmodem sz -rr @D:\BBS\Node5.Lst
  52.  
  53.   This would tell Ex to read configuration file 'Config.Fil' in the current
  54.   directory, then to run FZmodem to transfer files listed in D:\BBS\Node5.Lst.
  55.   
  56.   Example PROTOCOL.CTL entries for Maximus BBS and DSZ:
  57.     Protocol Zmodem
  58.     [...]
  59.     Download   Ex Dsz port %P speed %W estimate 0 %b ha rts -Z sz @dsz%k.ctl
  60.     [...]
  61.     End Protocol
  62.   Or, for multi node systems:
  63.     Protocol Zmodem
  64.     [...]
  65.     Download   Ex -cEx%k.Cfg Dsz port %P speed %W estimate 0 %b ha rts -Z
  66.      sz @dsz%k.ctl
  67.     [...]
  68.     End Protocol
  69.  
  70. Config file
  71.   The default config file is Ex.Cfg located in the current directory, and
  72.   needs only 2 verbs -- CopyDir and Volume.  Only one CopyDir is permitted but
  73.   up to 5 Volumes (25 in registered version) are supported.  A cut-and-paste
  74.   example config file is:
  75.  
  76.   ; Sample config file for Ex
  77.   ;  (All verbs must begin in first column!)
  78.   ;
  79.   ; Where to copy files to ...
  80.   CopyDir C:\Temp
  81.   ;
  82.   ; Drives that we want to copy from and not download directly off of
  83.   Volume P:
  84.   Volume Q:
  85.   Volume R:\
  86.   ; Alternate method for CD-ROM servers:
  87.   Volume \\Cd-Server\CD-1
  88.   Volume \\Cd-Server\CD-2
  89.   ;
  90.   ; Maximum limits: 1 CopyDir, 5 Volumes.  (Registered version is 25 Volumes)
  91.   ;
  92.   ; End of Ex.Cfg
  93.  
  94.  
  95. Multi-Node
  96.   Ex will run multi-node with either a single config file or a config file for
  97.   each node.  Ex will only delete the files it copied, so all nodes can share
  98.   the same CopyDir directory.  Should the same file be downloaded from
  99.   multiple nodes simultaneously, Ex will only copy the file once for the first
  100.   node that exits to download, the others will still download off of CD-ROM.
  101.   This is a safety feature; if EX can't copy a file it leaves the redirection
  102.   file unchanged and downloads from CD-ROM will be downloaded from CD-ROM.
  103.  
  104.  
  105. Warranty
  106. *******************************************************************************
  107.   No warranty, expressed nor implied.  User determines usability of program
  108.   and assumes all responsibilities for the usage of this program.  Feedback is
  109.   welcomed.  Send feedback to the above US Mail address, or electronic mail to
  110.   FidoNet 1:380/25 or 1:380/5, internet remus@f25.n380.z1.fidonet.org  Support
  111.   sites are Strange Systems at 318-869-4006 or MSG Resources at 318-865-4503.
  112.   Latest version of Ex can be found on either of these systems in the STRANGE
  113.   download directory or file requested as 'EX' from either system.
  114. *******************************************************************************
  115.  
  116.   (Maximus (C)Copyright Scott Dudley, DSZ (C)Copyright Omen Technologies)
  117.  
  118.